This document will guide you through the installation steps of the softwares needed for the hands-on sessions.
The steps are self-explainable, please perform all the installation steps in the menu on the left, prior to the workshop.
Don’t worry about your operating system. We have written installation options for Windows, Mac, and Linux.
Estimated time needed for this installation: 30 min - 1 hour
After finishing this guide, you have a working installation of:
- RStudio Desktop 1.4.1106 and >R4.0, and packages
- Python, Julia
- Circos
Let’s get started!
R and RStudio are the basic programs used in this course. If you have already an R-version installed, take a moment to check if you are running the same version, R4.0.4. Our install will not mess up previous installed R-instances. So we recommend you to follow the R installation steps.
For windows, you need RStudio for windows, and R-version 4.0.4 for windows. For Mac, you can download RStudio for Mac and R-version 4.0.4 for Mac. For Linux, e.g. Ubuntu 20.04, follow these instructions. If you have an account on the Flemish supercomputer and need help to Run R from there, mail me: sofie.thijs@uhasselt.be. For other OS, read here. Execute the RStudio.exe and also the R4.0.4.exe, using the default settings.
Tip: Choose language in English, if you want us to help understand error messages :-)
Make a folder called MDAW e.g. in C:/Users/yourname/Documents. In this folder, place the MDAW.zip file and Unzip(“MDAW.zip”) it.
Go to the MDAW folder that you created in step 2. Double click on the MDAW.Rproj, it will open in Rstudio. Click file, open file, and navigate to your MDAW folder, and open the file 1.Initialise.R. In RStudio, please first check if you are using R 4.0.4 version. For this click, Tools > Global Options > and check which version is loaded under ‘R version’, select the 4.0.4 version if not already there. Click Apply, Ok. Now you are ready to run 1.initialise.R.
Follow the instructions in the 1.Initialise.R file and execute all steps.
The last command renv:restore can take 0.5 hour because it will auto-install all packages needed for the workshop, in the meantime you can watch this 15 min video to learn the basics of R, what is the console etc...
Next, same as before, click file, open file, and navigate to your MDAW folder, and open 2.Setup.R. Follow the instructions in the 2.Setup.R file, the script will download datasets that we will use for the workshop. When it is finished (2 min), you will get the message ‘success’.
All done for Rstudio and R! You can proceed with the installation of Julia and python!
You will need Julie and python to folow along the network analyses Tutorial #5:
1)Install FlashWeave (and Julia)
With Circos you can visualise the correlations between microbiome data, transcriptomics data and various metadata such as metabolomics data-sets. You will use this software in Tutorial #4.
Sneak preview:
If you had installation problems, you can schedule a one-one meeting with us in Gather-town. From April 12, you can book a time slot.